JMNewAppletLocatorIM:JM

Inside Macintosh: JManager Reference /

Chapter 1 - JManager Reference / JManager Functions

JMNewAppletLocator
Locates an applet asynchronously by fetching an HTML document from a specified URL.
OSStatus JMNewAppletLocator (
JMAppletLocatorRef* locatorRef, 
JMSessionRef session, 
const JMAppletLocatorCallbacks* callbacks, 
const char* url, 
const char* htmlText, 
JMClientData data);
locatorRef
A pointer to the locator. On return, this parameter is the new applet locator.
session
The session in which you want to instantiate the applet.
callbacks
A pointer to an applet locator callbacks structure. For more information, see "Applet Locator Callback Structure" (page 16).
url
A null-terminated string containing the text of the URL.
htmlText
Optional text containing one or more applet tags.
data
Optional client-specific data.
function result
A result code. See "JManager Result Codes" (page 69) for a list of result codes that JManager may return in this field.

DISCUSSION
If you have already retrieved the HTML document, you can pass it to JMNewAppletLocator in the htmlText argument. Otherwise, JMNewAppletLocator starts a separate thread to retrieve the document. The client application must call JIdle to allow the new thread time to retrieve the document. The callback that executes upon fetching the HTML document can occur either while this function is executing or some time after it has returned.

SEE ALSO
The JMNewAppletLocatorFromInfo function (page 35).
The JMDisposeAppletLocator function (page 36).